home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / lstcrc14.arc / LISTCRCS.HST < prev    next >
Text File  |  1991-09-11  |  6KB  |  115 lines
  1. Revision history for LISTCRCS:
  2.  
  3.  - I never thought such a simple utility would need a revision history,
  4.    which only goes to show how cocky I was. <GRIN> The next utility I
  5.    write *will* have a beta-testing phase...
  6.  
  7.  - Version 1.0 (initial release): Advertised to Region 12 *EC's, Binkley
  8.    beta testers and QM beta testers. Initial motivation for problem was
  9.    a potential bug report by one NEC in Region 12 in the behavior of
  10.    Areafix.
  11.  
  12.  - Version 1.1: Added detection and flagging of existing collisions
  13.    (translate: the tinkering bug bit me good...). Additional
  14.    distribution: Net 167 file sharing area, called QUEDIST.
  15.  
  16.  - Version 1.2: Expanded the definition of "blank line"; the program now
  17.    treats as such not only true empty lines, but also lines starting with
  18.    a semicolon (";") or a dash ("-"). Thanks to a bug report from Bob
  19.    Davis (1:106/114), I was reminded that my habit of using truly blank
  20.    lines as visual separators was not as widespread as I first thought.
  21.    The QM documentation does, indeed, mention the semicolon as a comment
  22.    line flag. As for the dash, a remark by Raymond Beriau (1:167/305)
  23.    reminded me that ex ConfMail users may have brought such lines with
  24.    them. I now remember that *I* did keep such a line in my AREAS.BBS
  25.    file for a while when I first tried QM. Thank you Raymond!
  26.  
  27.    Any other type of non-area, non-standard lines in your AREAS.BBS file
  28.    may still produce "interesting" output (as in the old Chinese curse:
  29.    "May you live in interesting times..." <grin>). I will let rule #1
  30.    of data processing, G.I.G.O. (if you don't know what it means, ask a
  31.    local friend), take care of such situations. As I believe I have now
  32.    accounted for all documented line formats, and one old inherited
  33.    (from ConfMail) format, (here goes: Open Mouth, Insert Foot... 8-), I
  34.    do not expect to have to fiddle much more with this. Unless I get
  35.    early problem reports from Bob, Raymond or anyone else to whom I
  36.    will now send this version, this is what will be released in the SDS
  37.    in a few days.
  38.  
  39.  - Version 1.3: In the light of what the present paragraph says, you may
  40.    have a good chuckle when reading the rest of this file... If so, well
  41.    have a good one on me! This will only go to show that I am, after all,
  42.    very human, in that I can make the *dumbest* mistakes... It was just
  43.    brought to my attention that EchoMail area tag names are
  44.    case-insensitive (as if I didn't know it... ha!). It's just that I
  45.    made the fatal assumption that everyone would use all UPPERCASE
  46.    conference names in their AREAS.BBS file, but in fact there is no
  47.    obligation of doing this. My thanks to Jan Ceuleers of 2:295/53 for
  48.    pointing this out. This and some clarifications in my useless little
  49.    errorlevel-testing batch file are the only changes between versions
  50.    1.2 and 1.3.
  51.  
  52.  - Version 1.4: 91/09/10 (Tuesday morning, in the "wee hours"... :-)
  53.    In the time-honored tradition of many other FidoNet utilities, I am
  54.    only documenting the changes for version 1.4 in this addendum rather
  55.    than redo the original documentation file, mostly because I don't have
  56.    a minute to spare, and I want to push this thing out the door and go
  57.    to sleep!
  58.  
  59.    I wholeheartedly believed that the previous version (1.3) of this
  60.    utility would be the last to see the light of day before QM either
  61.    was fixed, or was made obsolete by some other program. Alas, this
  62.    was not to be! John Souvestre (1:391/1) recently came to me (via
  63.    NetMail... :-) with requests for additional features, both for
  64.    himself and on behalf of Tony Davis, our ZEC. As they were just
  65.    challenging enough for an evening of tinkering, I put them in,
  66.    and here they are:
  67.  
  68.    - Two optional command-line parameters are now supported. The area
  69.      name to test is now the second one, with the first being the name
  70.      of the file containing the list of areas. That file name can also
  71.      contain a drive and/or path name, if so desired.
  72.  
  73.    - If only a file name is supplied, version 1.4 will behave with it
  74.      exactly as 1.3 did with zero parameters, i.e. it will check all
  75.      areas listed in that file for a possible CRC collision, which
  76.      would guarantee a cross-link. If two parameters are supplied, the
  77.      second one is interpreted as the name of an EchoMail area that you
  78.      wish to create, and which is checked for cross-links against all
  79.      areas listed in the file referenced by the first parameter.
  80.  
  81.    - If no parameters are supplied, the file defaults to "AREAS.BBS",
  82.      which must then reside in the current directory.
  83.  
  84.    - An additional format is supported, in addition to AREAS.BBS for
  85.      QM and QECHO. The new format is popularly known, around these parts
  86.      anyway, as FIDONET.NA (where NA stands for "North America"), as this
  87.      is the name of the text-format forwarding list being used by the
  88.      North American EchoMail backbone to list all backbone areas.
  89.  
  90.    - The logic by which the file format is identified now starts with an
  91.      examination of the first line of the file. If that line contains
  92.      the character '!' anywhere, the file is presumed (NO, I won't use
  93.      "ass-u-me-d"...! :-) to be some form of AREAS.BBS listing, and
  94.      further testing along that path is done, just as before, to
  95.      differentiate between the QM and QECHO formats. If no '!' is found
  96.      on that first line, the file is presumed to be in FIDONET.NA
  97.      format. Comments and area descriptions will be ignored if present in
  98.      a FIDONET.NA format file.
  99.  
  100.    - The program's output is now split between the DOS standard output and
  101.      standard error streams. This provides the user with the ability to
  102.      produce a brief form of report by the simple expedient of redirecting
  103.      the standard output to NUL. What remains is then an abbreviated header,
  104.      and only CRC collisions are listed, while non-affected areas produce
  105.      no visible output. Now those people with the "too fast" computers, like
  106.      John and Tony <grin>, will be able to use LISTCRCS without fear of
  107.      missing important error messages as the output whizzes by on their
  108.      screens!  :-)
  109.  
  110.    - Hopefully, the HORRIBLE holes I had left on the errorlevel logic of
  111.      version 1.3 (but that nobody ever reported to me...) are now really
  112.      fixed!
  113.  
  114.  
  115.